<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<link rel="stylesheet" type="text/css" href="href://wiki.jajuk.info/index.php?title=MediaWiki:Common.css&amp;action=raw" />
<title>
using custom properties</title>
</head>
<body>
<h1>
using custom properties</h1>
<p>
Go back to <a href="table_of_contents.html">
table of contents</a>
</p>
<p>
Jajuk offers a way to add custom attributes on almost any item (files, playlists, artists, albums...). Imagine you're not happy with the integrated rating system: just create a custom 'my rate' number attribute on tracks. Other case: you want to store physical location of your CDs; create a String custom attribute on devices. You want to store the date you listened tracks: create a date-based custom property and so forth...</p>
<p>
Notes:</p>
<ul>
<li>
Custom properties data is only stored in jajuk internal database and NOT in music files as tags (ID3 for ie) so this information will not accessible from others players or jukeboxes.</li>
<li>
If you use this feature intensively, consider making backup of your collection files (see <a href="using_devices#collection_backup_and_restore.html">
Using_devices#Collection_backup_and_restore</a>
).</li>
</ul>
<h2>
How to create a new custom property ?</h2>
<p>
In frame top menu, select <i>
Properties</i>
 / <i>
Create custom property</i>
. The new property wizard features:</p>
<ul>
<li>
<i>
Item</i>
: Choose the item type you want to add custom property on. It can be physical (Device, Directory, File, Playlist File) or logical (Genre, Artist, Album, Track, Playlist). </li>
<li>
<i>
Custom property name</i>
: The property name. Note that some names are reserved like "name, id...". You will get an error message if you try to use them.</li>
<li>
<i>
Type</i>
: Property type. Jajuk supports: Numbers, Float, Strings, Dates or Booleans (true/false).</li>
<li>
<i>
Default value</i>
 (optional): A given default value. Depending on property type, you will be able to set it in the text field, using the date picker or checking the check box. If no default value is given, jajuk use these values: Numbers: 0, Float: 0.0, Strings: "", Dates: &lt;current day&gt;, Boolean: false.</li>
</ul>
<p>
Then, click on <i>
OK </i>
to create the custom property.</p>
<h2>
How to remove a custom property ?</h2>
<p>
In frame top menu, select <i>
Properties</i>
 / Remove <i>
custom property</i>
. The remove property wizard features:</p>
<ul>
<li>
<i>
Item</i>
: Choose the item type for which you want to remove custom property.</li>
<li>
<i>
Custom property name</i>
: The property name. </li>
</ul>
<p>
Then, click on <i>
OK </i>
to remove the custom property. Note that all values will be lost for this attribute. In case of manipulation error, see <a href="using_devices#collection_backup_and_restore.html">
Using_devices#Collection_backup_and_restore</a>
.</p>
<h2>
How to set values ?</h2>
<p>
Values for custom properties can be set the same way than standard ones. See : <a href="editing_tags_and_properties.html">
Editing tags and properties</a>
 page.</p>
<h2>
Using custom properties the Web 2.0 way</h2>
<p>
(thanks fsck222) Custom properties allow a "web 2.0" flavor searches:</p>
<ul>
<li>
Create a String custom properties on an item type (tracks, albums, files...)</li>
<li>
Edit tags on items you want to tag, example: "lyrics woman" on an item and "man lyrics" on another one</li>
<li>
Perform a search by filtering on the new created custom properties (or keep using the "any" filter). The search ignore words order so you can search for "man lyrics" or "woman" to find tagged items </li>
</ul>
<h3>
Tag your music using your key word: a concrete example</h3>
<ul>
<li>
In the perspective "Tracks", go in menu "Properties", create a new custom property using Item: "Title", Custom property name: "tag", type: "string".</li>
<li>
Now start tagging your music. Select in the "Tracks tree" or "tracks table" window items you want to put the same tag, do a right click. At the bottom of the property window, there is the custom property "Tag" were you can enter your key words. For this example we create a few selections with tags such as:<ul>
<li>
Selection 1: "jazz trio piano bass saxophone live"</li>
<li>
Selection 2: "jazz piano male singer live"</li>
<li>
Selection 3: "jazz female singer"</li>
<li>
Selection 4: "jazz bigband"</li>
<li>
Selection 5: "pop piano female singer live"</li>
</ul>
</li>
<li>
You can now perform search on tags in the filter bar (top of the "tracks table" view). Select filter "any" or "tag", then enter your key words. For example "live singer" will list any track tagged before in selection 1 and 5.</li>
</ul>
<p>
Go back to <a href="table_of_contents.html">
table of contents</a>
</p>
</body>
</html>
